KCCopyItem

KCCopyItem
Header:	Keychain.h		Carbon status:	Under Evaluation

Copies a keychain item from one keychain to another.

OSStatus KCCopyItem (
    KCItemRef item, 
    KCRef destKeychain, 
    KCItemRef *copy
);

item: A reference to the keychain item you wish to copy.
destKeychain: A reference to the keychain into which the item is to be copied.
copy: A pointer to a reference to the new copied keychain item.

function result: A result code. The result code errKCReadOnly indicates that the destination keychain is read only. The result code errKCNoSuchClass indicates that the item has an invalid keychain item class. The result code errKCInvalidItemRef indicates that the specified keychain item reference was invalid.

DISCUSSION

You can use the KCCopyItem function to copy a keychain item from one keychain to another. KCCopyItem returns the copied item in the copy parameter. KCCopyItem may display the Unlock dialog box if the keychain containing the item is currently locked.

VERSION NOTES

Available beginning with Keychain Manager 2.0.

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 2.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 2.0 and later.